Summary

Add output_path parameter to MCP tools (search_papers, fetch_paper). When specified, results are written to the file in JSON format, and only a summary is returned to the LLM.

Problem

Previously, MCP tools returned full results as text, which consumed many tokens for large responses. This was inefficient for LLM interactions.

Solution

• Add optional output_path parameter to both tools
• When output_path is specified:
  • Results are written to the file in JSON format
  • Only a summary is returned (e.g., paper titles, count, author count)
• When output_path is not specified:
  • Current behavior is maintained (returns full JSON as text)

Changes

• SearchPapersRequest: Add output_path parameter
• FetchPaperRequest: Add output_path parameter
• search_papers tool: Write to file, return titles and count
• fetch_paper tool: Write to file, return title and author count

Example Usage

Search with file output:

{
  "query": "quantum computing",
  "limit": 10,
  "output_path": "/tmp/results.json"
}

Returns: "Found 10 papers:\nPaper Title 1\nPaper Title 2\n..."

Fetch with file output:

{
  "id": "2512.04518",
  "output_path": "/tmp/paper.json"
}

Returns: "Fetched paper: Paper Title (5 authors)"

Test plan

• Pre-commit checks pass (fmt, clippy, test)
• Backward compatible (output_path is optional)

🤖 Generated with Claude Code